home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / nosvw137.zip / FTP < prev    next >
Text File  |  1991-09-18  |  13KB  |  343 lines
  1. ===                                                 NOSview [137]
  2. ftp
  3. ===
  4.  
  5. _________________________________________________________________
  6. ftp <host>
  7. _________________________________________________________________
  8. The command 'ftp' is used to initiate an FTP session with <host>.
  9. When the session is established, you will enter converse mode on
  10. the new FTP session.
  11.  
  12. When in converse mode with an FTP server, only the FTP sub-
  13. commands described below will be valid.  This will remain true
  14. until the FTP 'quit' command is issued, ending the FTP session,
  15. and returning you to the "net>" prompt.
  16.  
  17. When the connection between the two machines is opened, you'll
  18. get a banner from the remote machine, followed by a prompt for
  19. your user name and then your password.  If you've negotiated with
  20. the person at the remote machine to have a special user name and
  21. password set up for you in his or her FTPUSERS file, use that.
  22. (See NOSfiles\FTPUSERS for an example of the file).
  23.  
  24. If not, use one of the special user names, "anonymous" or "guest"
  25. or "bbs", and in this case, use your callsign as your password.
  26. Your password is recorded in the log file on the remote host,
  27. allowing the manager of that host to keep track of FTP activity.
  28.  
  29. To perform an automatic login to selected hosts, you can set up
  30. the NET.RC file.  Each line in the file contains the hostname,
  31. user login name and password, each item separated by a space.
  32. (See NOSfiles\NET.RC for an example of this file).
  33.  
  34.  
  35. ===============
  36. FTP SUBCOMMANDS
  37. ===============
  38. During converse mode with an FTP server, everything typed on the
  39. console is first examined to see if it is a locally-known
  40. command.  If not, the line is passed intact to the remote server
  41. on the control channel.
  42.  
  43. However, if it is one of the following commands, it is executed
  44. locally.
  45.  
  46.  
  47. -----------------------------------------------------------------
  48. abort
  49. -----------------------------------------------------------------
  50. Aborts a 'get/mget', 'put/mput', 'dir/ls' operation in progress.
  51. This is the only acceptable command when these operations are in
  52. progress; all other commands will result in an error message.
  53.  
  54. Abort is valid only when a transfer is in progress.  When a 'get'
  55. or 'put' operation is aborted, a partial copy of the transferred
  56. file will be left on the destination machine.  This copy must be
  57. removed manually if it is unwanted.
  58.  
  59. This is also true for a 'dir' or 'ls' operation when the
  60. directory listing is written as a local file.
  61.  
  62.  
  63. -----------------------------------------------------------------
  64. ascii
  65. -----------------------------------------------------------------
  66. Sets the file transfer mode to ASCII.  This is the same as the
  67. 'type a' command.
  68.  
  69.  
  70. -----------------------------------------------------------------
  71. batch on|off                                         Default: off
  72. -----------------------------------------------------------------
  73.  
  74.  
  75. >> Example:  batch on
  76.  
  77.  
  78. -----------------------------------------------------------------
  79. binary
  80. -----------------------------------------------------------------
  81. Sets the file transfer mode to binary, or "image" mode.  This is
  82. the same as the 'type i' command.
  83.  
  84.  
  85. -----------------------------------------------------------------
  86. cd <remote_directory>
  87. -----------------------------------------------------------------
  88. Changes the current directory on the remote host to the directory
  89. indicated by <directory>, which must be an existing directory on
  90. the remote host.  The directory specified can be relative to the
  91. current directory, or absolute, with the name beginning at the
  92. root (/).
  93.  
  94. >> Example:  cd public/tmp
  95.  
  96.  
  97. -----------------------------------------------------------------
  98. dele <remote_filename>
  99. -----------------------------------------------------------------
  100. Deletes a file on the remote system.  You must have delete
  101. privilege on the remote host to use this command.
  102.  
  103. >> Example:  dele foo.txt
  104.  
  105.  
  106. -----------------------------------------------------------------
  107. dir [<remote_filename>|<remote_directory>  [<local_filename>]]
  108. -----------------------------------------------------------------
  109. Without arguments, 'dir' requests that a full directory listing
  110. of the remote server's current directory be sent to the terminal.
  111. The full listing gives the file names, sizes and creation dates.
  112.  
  113. If one argument is given, this is passed along in the LIST
  114. command; this can be a specific file or subdirectory that is
  115. meaningful to the remote file system.
  116.  
  117. If two arguments are given, the second argument is taken as the
  118. local file into which the directory listing should be put
  119. (instead of being sent to the console).  The PORT command is used
  120. before the LIST command is sent.
  121.  
  122. You should request a directory listing when you first log into an
  123. unfamiliar machine.  There will often be a file named 'readme' or
  124. 'whathere.txt' that will give some information about the files
  125. available on the remote machine.  This file can then be acquired
  126. with a "get" command (described below), and read on your machine
  127. to learn more about the files available on the remote host.
  128.  
  129. >> Example:  dir public
  130.  
  131.  
  132. -----------------------------------------------------------------
  133. get <remote_filename> [<local_filename>]
  134. -----------------------------------------------------------------
  135. Asks the remote server to send the file specified in the first
  136. argument.
  137.  
  138. The second argument, if given, will be the name of the file on
  139. the local machine; otherwise it will have the same name as on the
  140. remote machine. The PORT and RETR commands are sent on the
  141. control channel.
  142.  
  143. Before using 'get' you must set the correct transfer mode, using
  144. the 'type' command described below.
  145.  
  146. Use the 'abort command if you want to terminate the transfer
  147. before it has been completed.
  148.  
  149. >> Example:  get public/autoexec.bat
  150.  
  151.  
  152. -----------------------------------------------------------------
  153. hash
  154. -----------------------------------------------------------------
  155. A synonym for the 'verbose 3' command.
  156.  
  157.  
  158. -----------------------------------------------------------------
  159. list [<remote_filename> | <remote_directory> [<local_ filename>]]
  160. ls   [<remote_filename> | <remote_directory> [<local_ filename>]]
  161. -----------------------------------------------------------------
  162. The 'list' and 'ls' commands are identical to 'dir', except that
  163. the "NLST" command is sent to the server instead of the "LIST"
  164. command.  This results in an abbreviated directory listing; i.e.
  165. one showing only the file names themselves without any other
  166. information.
  167.  
  168. >> Example:  ls public
  169.  
  170.  
  171. -----------------------------------------------------------------
  172. mget <remote_filename> [<remote_filename> ...]
  173. -----------------------------------------------------------------
  174. Fetch a collection of files from the server.  File names may
  175. include wild card characters; they will be interpreted and
  176. expanded into a list of files by the remote system using the NLST
  177. command.  The files will have the same name on the local system
  178. that they had on the server.
  179.  
  180. Before using 'mget' you must set the correct transfer mode, using
  181. the 'type' command described below.
  182.  
  183. Use the 'abort command if you want to terminate the transfer
  184. before it has been completed.
  185.  
  186. >> Example:  mget *.txt
  187.  
  188.  
  189. -----------------------------------------------------------------
  190. mkdir <remote_directory>
  191. -----------------------------------------------------------------
  192. Creates a directory on the remote machine.  You must have write
  193. privilege on the remote machine to use this command.
  194.  
  195. >> Example:  mkdir tmp
  196.  
  197.  
  198. -----------------------------------------------------------------
  199. mput <local_filename> [<local_filename> ...]
  200. -----------------------------------------------------------------
  201. Send a collection of files to the server.  File names may include
  202. wild card characters; they will be expanded locally into a list
  203. of files to be sent.  The files will have the same name on the
  204. server as on the local system.
  205.  
  206. Before using 'mput' you must set the correct transfer mode, using
  207. the 'type' command described below.
  208.  
  209. You must have write privilege on the remote host to use this
  210. command.
  211.  
  212. Use the 'abort command if you want to terminate the transfer
  213. before it has been completed.
  214.  
  215. >> Example:  mput *.txt
  216.  
  217.  
  218. -----------------------------------------------------------------
  219. pass <password>
  220. -----------------------------------------------------------------
  221. Normally you will be asked for your password when you log in to
  222. FTP.  However, if you mistype your password and the remote system
  223. rejects it, you can then try again with the 'pass' command.
  224.  
  225. >> Example:  pass foobar
  226.  
  227.  
  228. -----------------------------------------------------------------
  229. put <local_filename> [<remote_filename>]
  230. -----------------------------------------------------------------
  231. Send a local file to the server.  The second argument, if given,
  232. will be the name of the file on the remote machine; otherwise it
  233. will have the same name as on the local machine.  The PORT and
  234. STOR commands are sent on the control channel.
  235.  
  236. Before using 'put' you must set the correct transfer mode, using
  237. the 'type' command described below.
  238.  
  239. You must have write privilege on the remote host to use this
  240. command.
  241.  
  242. Use the 'abort command if you want to terminate the transfer
  243. before it has been completed.
  244.  
  245. >> Example:  put myfoo.txt yourfoo.txt
  246.  
  247.  
  248. -----------------------------------------------------------------
  249. pwd
  250. -----------------------------------------------------------------
  251. Displays the name of the current directory on the remote host.
  252. ('pwd' literally means "print working directory".
  253.  
  254.  
  255. -----------------------------------------------------------------
  256. quit
  257. -----------------------------------------------------------------
  258. Terminates the FTP session and returns you to the "net>" prompt.
  259.  
  260.  
  261. -----------------------------------------------------------------
  262. rmdir <remote_directory>
  263. -----------------------------------------------------------------
  264. Deletes a directory on the remote machine.  You must have delete
  265. privilege on the remote host to use this command.
  266.  
  267. >>  Example:  rmdir tmp
  268.  
  269.  
  270. -----------------------------------------------------------------
  271. type [a | i | l <bytesize>]                            Default: a
  272. -----------------------------------------------------------------
  273. Tells both the local client and remote server the type of file
  274. that is to be transferred.  The 'type' command sets the local
  275. transfer mode and generates the TYPE command on the control
  276. channel.
  277.  
  278. Type 'a' means ASCII (i.e. a text file).  In ASCII mode, files
  279. are sent as varying length lines of text in ASCII separated by
  280. CR/LF sequences.  The 'type a' command is the same as 'ascii'.
  281.  
  282. Type 'i' means image (i.e. binary).  In image mode, files are
  283. sent exactly as they appear in the file system.  The 'type i'
  284. command is the same as 'binary'.
  285.  
  286. Type 'l' (logical byte size) is used when exchanging binary files
  287. with remote servers having oddball word sizes (eg. DECSYSTEM-10s
  288. and 20s).  Locally it works exactly like image, except that it
  289. notifies the remote system how large the byte size is.  The
  290. parameter <bytesize> is typically 8.
  291.  
  292. ASCII mode should be used whenever transferring text between
  293. dissimilar systems (eg. UNIX and DOS) because of their different
  294. end-of-line and/or end-of-file conventions.  When exchanging text
  295. files between machines of the same type, either mode will work
  296. but image mode is usually faster.
  297.  
  298. Naturally, when exchanging raw binary files (executables,
  299. compressed archives, etc) image mode must be used.
  300.  
  301. See also the 'ftype' command.
  302.  
  303. >> Example:  type a
  304.  
  305.  
  306. -----------------------------------------------------------------
  307. user <username>
  308. -----------------------------------------------------------------
  309. Normally you will be asked for your username when you log in to
  310. FTP.  However, if you mistype your name and the remote system
  311. rejects it, you can then try again with the 'user' command.
  312.  
  313. >> Example:  user phil
  314.  
  315.  
  316. -----------------------------------------------------------------
  317. verbose [0 | 1 | 2 | 3]                                Default: 2
  318. -----------------------------------------------------------------
  319. Set or display the level of message output in file transfers.
  320. Verbose 0 gives the least output, and verbose 3 the most, as
  321. follows:
  322.  
  323. 0:  Display error messages only.
  324.  
  325. 1:  Display error messages plus a one-line summary after each
  326.     transfer giving the name of the file, its size, and the
  327.     transfer time and rate.
  328.  
  329. 2:  Display error and summary messages plus the progress messages
  330.     generated by the remote FTP server.
  331.  
  332. 3:  Display all messages. In addition, a "hash mark" (#) is
  333.     displayed for every 1,000 bytes sent or received.  'verbose
  334.     3' is equivalent to 'hash'
  335.  
  336. If a command is sent to the remote server because it is not
  337. recognized locally, the response is always displayed, regardless
  338. of the setting of 'verbose'.  This is necessary for commands like
  339. 'pwd' (display working directory), which would otherwise produce
  340. no message at all if 'verbose' were set to 0 or 1.
  341.  
  342. >> Example:  verbose 0
  343.